<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>更新整个文档 | Elasticsearch: 权威指南 | Elastic</title>
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
</head>
<body>
<div class="main-container">
    <section id="content">
        
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原文地址: <a href="https://www.elastic.co/guide/cn/elasticsearch/guide/current/update-doc.html" rel="nofollow">https://www.elastic.co/guide/cn/elasticsearch/guide/current/update-doc.html</a>, 版权归 www.elastic.co 所有<br/>
                            英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/guide/current/update-doc.html" rel="nofollow">https://www.elastic.co/guide/en/elasticsearch/guide/current/update-doc.html</a>
                            </div>
                        <!-- start body -->
                  <div class="page_header">
<b>请注意:</b><br>本书基于 Elasticsearch 2.x 版本，有些内容可能已经过时。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch: 权威指南</a></span>
»
<span class="breadcrumb-link"><a href="getting-started.html">基础入门</a></span>
»
<span class="breadcrumb-link"><a href="data-in-data-out.html">数据输入和输出</a></span>
»
<span class="breadcrumb-node">更新整个文档</span>
</div>
<div class="navheader">
<span class="prev">
<a href="doc-exists.html">« 检查文档是否存在</a>
</span>
<span class="next">
<a href="create-doc.html">创建新文档 »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="update-doc"></a>更新整个文档<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elasticsearch-cn/elasticsearch-definitive-guide/edit/cn/030_Data/25_Update.asciidoc">edit</a>
</h2>
</div></div></div>
<p>在 Elasticsearch 中文档是 <em>不可改变</em> 的，不能修改它们。相反，如果想要更新现有的文档，需要 <em>重建索引</em> 或者进行替换，
我们可以使用相同的 <code class="literal">index</code> API 进行实现，在 <a class="xref" href="index-doc.html" title="索引文档">索引文档</a> 中已经进行了讨论。</p>
<div class="pre_wrapper lang-sense">
<pre class="programlisting prettyprint lang-sense">PUT /website/blog/123
{
  "title": "My first blog entry",
  "text":  "I am starting to get the hang of this...",
  "date":  "2014/01/02"
}</pre>
</div>
<div class="sense_widget" data-snippet="snippets/030_Data/25_Reindex_doc.json"></div>
<p>在响应体中，我们能看到 Elasticsearch 已经增加了 <code class="literal">_version</code> 字段值：</p>
<div class="pre_wrapper lang-js">
<pre class="programlisting prettyprint lang-js">{
  "_index" :   "website",
  "_type" :    "blog",
  "_id" :      "123",
  "_version" : 2,
  "created":   false <a id="CO10-1"></a><i class="conum" data-value="1"></i>
}</pre>
</div>
<div class="calloutlist">
<table border="0" summary="Callout list">
<tr>
<td align="left" valign="top" width="5%">
<p><a href="#CO10-1"><i class="conum" data-value="1"></i></a></p>
</td>
<td align="left" valign="top">
<p><code class="literal">created</code> 标志设置成 <code class="literal">false</code> ，是因为相同的索引、类型和 ID 的文档已经存在。</p>
</td>
</tr>
</table>
</div>
<p>在内部，Elasticsearch 已将旧文档标记为已删除，并增加一个全新的文档。
尽管你不能再对旧版本的文档进行访问，但它并不会立即消失。当继续索引更多的数据，Elasticsearch 会在后台清理这些已删除文档。</p>
<p>在本章的后面部分，我们会介绍 <code class="literal">update</code> API, 这个 API 可以用于 <a class="xref" href="partial-updates.html" title="文档的部分更新">partial updates to a document</a> 。
虽然它似乎对文档直接进行了修改，但实际上 Elasticsearch 按前述完全相同方式执行以下过程：</p>
<div class="olist orderedlist">
<ol class="orderedlist">
<li class="listitem">
从旧文档构建 JSON
</li>
<li class="listitem">
更改该 JSON
</li>
<li class="listitem">
删除旧文档
</li>
<li class="listitem">
索引一个新文档
</li>
</ol>
</div>
<p>唯一的区别在于,  <code class="literal">update</code> API 仅仅通过一个客户端请求来实现这些步骤，而不需要单独的 <code class="literal">get</code> 和 <code class="literal">index</code> 请求。</p>
</div>
<div class="navfooter">
<span class="prev">
<a href="doc-exists.html">« 检查文档是否存在</a>
</span>
<span class="next">
<a href="create-doc.html">创建新文档 »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>